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About This Document 


This document provides the basic instructions to deploy Micro Focus Filr Appliance. Refer to the Filr 4: 
Installation, Deployment, and Upgrade Guide for any detailed information. 


The Filr Appliance can be deployed on virtualization software that can run the .ovf (VMware ESXi), vmdk 
(Hyper-V) , .xva (Citrix XenServer), or .xen (Xen on SUSE Linux Enterprise Server (SLES)) file formats. 


IMPORTANT: This document should only be used to set up an evaluation environment for Filr. If you are 
deploying Filr in a production environment, refer to the Planning Your Filr Deployment - Best Practices guide. 
(https://www.microfocus.com/documentation/filr/filr-4/filr-bp-plan-deploy/bookinfo.html) 


Filr Evaluation version is available in .ov£ format. This document uses VMware Web Client as an example to 
deploy the Filr Appliance. 


Prerequisites 


+ IP address details for the appliance: 

¢ Static IP address 

¢ Network mask 

¢ Gateway IP address 

¢ Host name associated with the IP address 

+ IP address of a DNS server 
+ NTP server - IP address or host name 
¢ Primary Hard Disk: 20 GB (minimum). This disk stores the system files and executables. 
¢ Hard Disk 1: 20 GB (minimum). This disk stores the configuration and monitoring data. 
¢ Hard Disk 2: 20 GB (minimum). This disk stores the logging data. 


Deploying Filr Appliance 


1 Download and extract the Filr Appliance software. 
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You can download an evaluation version of the software from the Filr Trial Downloads page (https:// 
www.microfocus.com/products/filr/trial/). 


2 Ona Web browser, enter the URL for the vSphere Web Client and login with the root credentials. 
3 Right-click on the Virtual Machines and click Create/register VM. 


vmware’ ESXi” 





h Create / Register VM | =? Console | þ Poweron W Poweroff Wi Suspend | CG Refresh | 


LJ | Virtual machine a @ Status @ Used space v Guest OS 
r i i = No virtual machines _ 
ee Virtual Machine E ikal machines a 


@u Create/Register VM v | 


Create or register a virtual machine using a wizard 





4 On the Select creation type page, select Deploy a virtual machine from an OVF or OVA file, then 


click Next. 


CS Select creation type 


2 Select OVF and VMDK files How would you like to create a Virtual Machine? 
3 Select storage 


4 License agreements i i j 
che a paai aa This option guides you through the process of creating a 
5 Deployment op virtual machine from an OVF and VMDK files. 


Deploy a virtual machine from an OVF or OVA file 


Register an existing virtual machine 





Ce Lee Fe 


5 In the Select OVF and VMDK files page, specify the name for the virtual machine. For example, 


Demo-VM. Upload the ovf and vmdk files of Filr, and click Next. 


April 2019 


Select OVF and VMDK files 
Select the OVF and VMDK files or OVA for the VM you would like to deploy 


Enter a name for the virtual machine. 


Virtual machine names can contain up to 80 characters and they must be unique within each ESXi instance. 


* Filr.x86_64-4.0.0.155.ovf 
x = Filr.x86_64-4.0.0.155-disk1.vmdk 


6 On the Select Storage page, select a storage repository where the disk images for the imported VMs will 
be placed. Review the datastore details, and select an appropriate disk format from the available options. 
Retain all the other default settings, and click Next. 





# 1 Select creation type Select stor age 


V 2 Select OVF and VMDK files Select the storage type and datastore 


standard] Persistent Memory 


Select a datastore for the virtual machine's configuration files and all of its' virtual disks. 


Name v | Capacity + | Free {v | Type v | Thin pro... v | Access v 


datastore1 3.27 TB 632.68GB VMFS6 Supported Single 


1 items 





Ce JL ner Le JL cre | 


7 Inthe Deployment options page, uncheck Power on automatically (so that the VM can be powered on 
after adding the disks), and click Next. 
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V 1 Select creation type Deployment options 
vV 2 Select OVF and VMDK files Select deployment options 
# 3 Select storage 


LA 4 Deployment options - l 


Disk provisioning © Thin © Thick 











Power on automatically D 














v 1 Select creation type Ready to complete 


V 2 Select OVF and VMDK files Review your settings selection before finishing the wizard 
v 3 Select storage 


vY 4 Deployment options 
Ed 5 Ready to complete 





Product Filr.x86_64-4.0.0.155 





VM Name Demo-VM 





Disks Filr.x86_64-4.0.0.155-disk1.vmdk 





Datastore datastore1 





Provisioning type Thin 





Network mappings bridged: VM Network 


Guest OS Name Unknown 


A Do not refresh your browser while this VM is being deployed. 





pack || Net || Fen || cancel 


9 Add two (2) hard disks to store the appliance configuration and log information. 


9a Right-click the virtual machine Demo-VM, then select Edit settings. 
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Ÿ Create / Register VM Poweron W Poweroff Wi Suspend | @ Refresh | Actions 





#1 Demo-VM 
Virtual mach atus @ Used space v | Guest OS @ Ho: 
ÉD Power 
O ; Nor... |: Unknown SUSE Linux Enterpris...  Unl 
5 W Guest OS ` id 





Quick filters... iB Snapshots 


Cy Console 


Fa Autostart 






à Upgrade VM Compatibility 


tæ Export 





re 
i 


» Edit settings 
Edit the settings for this virtual machine 


&, Permissions 













| Recent tasks Lg Edit notes 




















9b On the Virtual Hardware tab, click Add hard disk > New standard hard disk. This adds second hard disk. 





BS Edit settings - Demo-VM (ESXi 5.1 virtual machine) 








VM Options 
Œ Add hard disk | Bi Add network adapter SJ Add other device 





= New standard hard disk 


M Existing hard disk 


9c Click Add hard disk > New standard hard disk. This adds the third hard disk. 
9d The Filr VM now has three (3) hard disks. Click Save to successfully add the hard 
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disks. 





ČD Edit settings - Demo-VM (ESXi 5.1 virtual machine) 





VM Options 





Œ Add hard disk W Add network adapter § Add other device 


> [Fi CPU 4 v|@ 

> EE Memory VIB v 

> £3 Hard disk 1 GB + 

> CA New Hard disk GB v 

> 3 New Hard disk GB G 

i SCSI Controller 0 LSI Logic Parallel ¥ 
USB controller 1 USB 2.0 v 


Save Cancel 


Å 








10 Power on the appliance (virtual machine). 
10a Right-click the virtual machine Demo-VM, then select Power > Power On. 


The powering on process takes some time as Filr gets deployed only after powering on the virtual 
machine. You can navigate to the Console tab in your virtual machine to monitor the deployment 
process. 


11 When the VM is powered on, click Accept to accept the license agreement. 
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Configuration 


Filr Appliance License Agreement 


Finish Setup License Language Keyboard Language 


> Configure Appliance 


English english-us (English (US)) 


END USER LICENSE AGREEMENT 
MICRO FOCUS FILR 4 


IMPORTANT: LICENSOR IS PROVIDING THIS LICENSED SOFTWARE TO LICENSEE (THE ORIGINAL PUR 


For this End User License Agreement (“License Agreement”) the following terms shall h 
“Documentation” means the Licensor user documentation that 1s included with the Licen 


“Licensee” means the single legal entity or person that rightfully acquires the Licen 
“License Options” means those license options set forth in Annex 1 to this License Ag 
“Licensor” means Micro Focus Software Inc. 

“Licensed Software” means the object code version of the Licensor computer program(s) 


“Product Order” means a document that has been (1) executed by Licensee describing ea 


“Warranty Period” means a period of ninety (90) days from delivery of the Licensed So 


1 GRANT OF LICENSE; LICENSE CONDITIONS. For payment of the applicable non-refundable 
Different License Options are available from Licensor as set forth or referred to in 

USE RESTRICTIONS. Except as may be otherwise specifically permitted in Annex 1 or 

Copy and/or distribute the Licensed Software, in whole or in part, for int 
Use the Licensed Software for timesharing, facilities management, outsourc 
Modify the Licensed Software or provide any person with the means to do tt 
Create derivative works of the Licensed Software, or translate, disassembl 
Alter, destroy, or otherwise remove any proprietary notices or labels on c 
Use the Licensed Software in a manner other than as specifically permittec 


~ 


On un & &) A) Fe 


ii NNNNNNN 


Abort 





12 Inthe Configure Appliance page, specify all the required details such as root Password, vaadmin Password, 
NTP Server details, Region and its corresponding Time Zone. Click Next. 
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Configuration 


Filr Appliance Passwords and Time Zone 


> Configure Appliance 


Finish Setup 


root Password Confirm root Password 
@se268 eseged 
yaadmin Password Confirm vaadmin Password 


NIP Server (e.g. time.domain.com 
2.pool.ntp.org 
Optional NTP Server (e.g. time.domain.com) Optional NTP Server (e.g. time.domain.com) 


3.pool.ntp.org 


Time Zone 


Kolkata 





13 In the Filr Appliance Network Settings page, specify all the required details such as Hostname, IP Address, 
Network Mask, Gateway, DNS Server details, and Domain Search details. Click Next. 


TIP: Hostname is a fully qualified DNS host name associated with the appliance’s IP address. To get the 
hostname, go to the command prompt and type nslookup <ipaddress>. For example, nslookup 
192.168.1.255. 


April 2019 


Configuration 


Filr Appliance Network Settings 


> Configure Appliance 


+ Finish Setup 


Hostname (e.g. server.domain.com) 
filr.digitalairlines.com 


MAC Address eth0: 00:0c:29:48:18:71 


Heip 
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Configuration 


Filr Appliance Network Settings 


> Configure Appliance 
Finish Setup 


IP Address (e.g. 10.0.0.1 
192.168.1.255 


MAC Address eth0: 00:0c:29:48:18:71 


Network Mask (e.g. 2 


255.255.254.0 


Gateway (e.g. 10.0.0.2} 
10.10.10.1 
DNS Server (e.g. 10.0.0.1 
192.168.201.201 
Optional DNS Server (e.g. 10.0.0.2) Optional DNS Server (e.g. 10.0.0.3) 


192.168.201.202 


Domain Search (e.g. domain.com) 
digitalairlines.com 


Optional Domain Search (e.g. domain.com) Optiong! Domain Search (e.g. domain.com) 





14 Select a hard drive from the drop-down list. The additional hard drives are automatically detected and 
sdb is displayed as the hard drive. Click Next. 


NOTE: If you have not created a hard drive, sda is chosen as the default partition. This causes the Filr 
configuration to fail later. 
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Configuration 


Filr Appliance Data Store Location 


> Configure Appliance 


Finish Setup 


Select a drive and partition to use for this appliance's data 


Hard Drive 


sdb 


Create a new partition and specify the filesystem type to use 


Free Space For 


uninitialized none 20.000 GiB 


Filesystem Type 


ext3 i 








If you have created a separate virtual hard disk for the Filr Appliance, the Filesystem Type field is enabled. 
Retain the default values for this field. 


15 The Hard Drive field detects sdc, then click Next. 
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Configuration 


Filr Appliance Data Log Location 


> Configure Appliance 


Finish Setup 


Select a drive and partition to use for this appliance’s log data 


Hard Drive 


sdc 
Create a new partition and specify the filesystem type to use 
Fre 


urunitalized none 20.000 GiB 


Filesystem Type 


ext3 X 


Help 





If you have created a separate virtual hard disk for the Filr Appliance, the Filesystem Type field is enabled. 
Retain the default values for this field. 


16 Select the option No Remote Storage, then click Next. The configuration process may take some time as 
the Filr Appliance configures all the details that you have specified. 
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Configuration 


> Configure Appliance 


Finish Setup 


Filr Appliance Shared Storage Type 


Select one deployment option below, then click Next. 


Multi-Appliance Deployment (fault tolerance, high-availability) 


Requires remote shared storage 


\) Remote NFS 
Shared resource must already exist 


See the appliance’s installation instructions 


© Remote CIFS 


Share must already exist.See the applance's installation instructions 


All-in-One Deployment (single appliance) 


No Remote Storage 
Select only when high-availability and 
fault tolerance are not needed. 


Important: It is recommended to have 

4 CPUs and 16 GB RAM to handle the 

additional services required on an all-in-one appliance 
See the planning documentation for details 


Shut Down Appliance to Fix Resources 
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Upon successful installation, a message stating, “The system is ready for appliance configuration” is 
displayed. An URL and an IP address to access the Filr Console is displayed. Using a Web browser, you can 
navigate to the Filr Console URL. 


The system is ready for appliance configuration. 


To configure the appliance: 
1. At your management workstation, open a browser and enter one of the following URLs: 


https://filr.digitalairlines.com:9443 
https://192.168.1.255:9443 


2. Log in as vaadmin with the password that you set. 


IMPORTANT: Do not use the terminal prompt before consulting the documentation. 
Appliance administration requires appliance-specific tools. 
Using standard tools can result in service disruption or failure. 





Configuring Filr Appliance 


1 Ona Web browser, use either the host name or the IP address with port 9443 to access the Filr Console. 
For example, https://10.0.0.1:9443. 


Ignore the security certificate warning, and continue to the Filr Console. 
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2 Specify vaadmin or root as the username. 





3 Specify the password, then click Sign in. 


Specify the password that you have provided in Step 12 on page 7. The Filr page is displayed. 


Appliance Configuration Shutdown 


Reboot 
Sangha Networt Time Digtal Cerficates Storage Support Orne Update P 
Mentoring c 


Gangña A Proouct Upgrade 


System Services Frewat ARTESAN Ee Field Paton 
cofique adon Passwords 


Filr Appliance Tools 


& 


OR NON 
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4 Click the Configuration icon to launch the Filr Configuration Wizard. 
5 Select Small Deployment, then click Next. 


Filr Configuration Wizard 
Pick an option. 


Small Deployment 
Set up an evaluation environment or small network infrastructure. 
The Lucene search service and PostgreSQL database wil! be installed on this Filr virtual 
appliance. 

O Large Deployment 


Sel up a scalable infrastructure. 
The Lucene search server and the database (PosigreSQL or MS SQL) will run separately. 


Previous 





6 Specify and confirm a password for the filr user in the PostgreSQL database, then click Next. 
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Database 


Set the PosigreSQL administrator password on fhe database. 


User Name: filr 


_ Previous , 





7 In the Default Locale page: 
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Select the primary language of the Filr server 


Default Locale: 





English (United States) 


Enter fhe user id that will be used for the administrator account. The password for the administrator 
account will be identical to the user id you enter. 


Administrator User ID: 





Previous L 





7a Select your locale from the dropdown list. 
7b Change the Administrator User ID if you want to. For example, admin. 


The User ID that you have entered here is used as the password for the initial login for the 8443 
administration console. 


7c Click Finish. 


The configuration process takes some time. Do not close or exit the browser page until the warning 
message disappears. 


Congratulations! The Filr appliance is configured and running. 

Use this console to manage the appliance services listed on the left. 

To administer and use Filr services, click here, then log in using "admin" "admin as the “username and password. 

* If you changed the administrator username from "admin" in the installation wizard, enter your changed username as the username and password. 
For example, enter "my-admin-name" "my-admin-name". 


You will then be prompted to change the password. 
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8 To administer and use Filr services, click the link as stated in the above image or launch a Web browser, 
use either the host name or the IP address with port 8443. For example, https://10.0.0.1:8443. 





The user name and password are both admin. 


9 Specify a new password for the administration console, and click OK. 
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Change Password 


You are currently using the default password. For 
security reasons, you should change your password. 
Current password: 


FENTE 


New password: 


FETES 


Confirm new password: 








Filr is ready to use. 





Micro Focus 


a Wb à 


My F dos Shared wih Mo Shared by Me Net F oder: 





My Files 


2 


All your personal files are stored in one convenient location 
Personal files (My Files) include files that you upload to the Filr 
site and other personal files that are associated with your 
Home directory on a corporate server 


* 0040 > 


Legal Notice 


For information about legal notices, trademarks, disclaimers, warranties, export and other use restrictions, 
U.S. Government rights, patent policy, and FIPS compliance, see https://www.microfocus.com/about/legal/. 


Copyright © 2019 Micro Focus. All Rights Reserved. 
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